1. 确保已经安装 Flutter SDK
首先,确保的系统上安装了 Flutter SDK。如果没有安装,可以参考以下步骤:
安装 Flutter SDK:
访问 Flutter 官网 并下载适用于操作系统的 Flutter SDK。
解压下载的文件并将 Flutter 添加到系统路径中。
Windows:将
flutter/bin
目录添加到环境变量PATH
中。Mac/Linux:在
.bashrc
或.zshrc
文件中添加以下行:1
export PATH="$PATH:`<flutter_sdk_path>/flutter/bin"
确认 Flutter 是否安装:
在终端或命令提示符中运行以下命令来确认 Flutter 是否安装成功:
1 | flutter --version |
2. 安装 Android Studio 或其他 IDE(用于模拟器)
确保有一个 Android 模拟器,或者已连接真实设备(如果要进行 Android/iOS 开发)。可以安装 Android Studio 或直接使用 VS Code 进行开发,但 Android Studio 带有模拟器,便于开发。
- Android Studio:安装 Android Studio,并确保安装了 Android SDK 和模拟器。
- VS Code:VS Code 本身无法直接启动模拟器,但可以通过 Android Studio 提供的模拟器进行配合。
3. 在 VS Code 中安装 Flutter 插件
为了在 VS Code 中开发 Flutter 应用,需要安装两个插件:Flutter 和 Dart。
安装 Flutter 和 Dart 插件:
- 打开 VS Code。
- 转到 扩展(Extensions)视图:点击左侧活动栏中的 扩展 图标,或者使用快捷键
Ctrl+Shift+X
。 - 在搜索框中输入
Flutter
,然后点击 安装。 - 在搜索框中输入
Dart
,然后点击 安装。
4. 通过 VS Code 打开 Flutter 项目
使用 VS Code 打开由 GitHub Copilot 创建的 Flutter 项目文件夹。点击 文件 > 打开文件夹,然后选择的 Flutter 项目文件夹。
可以在 VS Code 的 终端(Terminal)中运行以下命令,确保所有依赖已安装:
1
flutter pub get
5. 连接设备或启动模拟器
连接设备:如果有 Android 或 iOS 设备连接到计算机,可以直接使用设备运行应用。
启动模拟器:
- 如果使用的是 Android Studio,可以通过 AVD 管理器(Android Virtual Device)启动模拟器。
- 启动模拟器后,VS Code 会自动检测到模拟器。
也可以通过 命令面板(
Ctrl+Shift+P
)运行以下命令:1
Flutter: Launch Emulator
6. 在 VS Code 中运行 Flutter 应用
确保设备或模拟器已连接并显示在 VS Code 状态栏的 设备选择 处。
在 VS Code 中按下
F5
或点击 运行(Run)按钮来启动应用。也可以使用 终端 执行:1
flutter run
VS Code 将会构建并运行的 Flutter 应用,输出将在 终端 中显示。
7. 调试与热重载
- 在运行 Flutter 应用时,VS Code 支持热重载(Hot Reload)。只需点击 热重载 图标或在终端中输入
r
,就可以查看代码修改后的效果。 - 还可以设置断点并调试应用。
总结:
- 确保安装了 Flutter 和 Dart 插件。
- 通过 VS Code 打开 Flutter 项目。
- 确保连接设备或启动模拟器。
- 使用
F5
运行应用,或通过终端输入flutter run
。
8.avdmanager is missing from the Android SDK
1. 确保 Android SDK 安装完整
AVD Manager
是 Android Studio 中的一部分,但它依赖于 Android SDK 的某些工具。因此,确保的 SDK 已经安装并更新到最新版本。
安装或更新 SDK 工具:
打开 Android Studio。
选择 Configure > SDK Manager。
在 SDK Tools 标签页中,确保以下工具已经选中并安装:
- Android SDK Build-Tools
- Android Emulator
- Android SDK Platform-Tools
- Android SDK Tools(如果显示)
点击 OK 以应用更改并安装缺失的工具。
2. 手动安装 AVD Manager
如果没有 Android Studio,或者只安装了命令行工具,可以手动安装并配置 AVD Manager
。
安装 AVD 工具:
打开终端或命令行。
使用
sdkmanager
工具来安装缺少的组件。确保已经将 Android SDK 的路径添加到PATH
环境变量中。如果没有,可以在终端中运行:1
2
3
4sdkmanager --update
sdkmanager "system-images;android-30;google_apis;x86_64"
sdkmanager "platform-tools"
sdkmanager "emulator"上面的命令会安装 SDK 平台工具、模拟器和系统映像(适用于 Android 30)。
等待下载并安装完成。
3. 检查环境变量
确保 AVD Manager
所需的命令行工具在的 PATH
中。
设置环境变量:
Windows:
打开 系统属性 > 高级系统设置 > 环境变量。
在 系统变量 中找到 Path,并点击 编辑。
添加以下路径(替换为实际的 Android SDK 路径):
1
2C:\Users\<YourUsername>\AppData\Local\Android\Sdk\tools
C:\Users\<YourUsername>\AppData\Local\Android\Sdk\platform-tools
Mac/Linux:
打开终端并编辑
.bashrc
或.zshrc
文件:1
nano ~/.bashrc # 或 nano ~/.zshrc
添加以下行:
1
2export PATH=$PATH:/Users/<YourUsername>/Library/Android/sdk/tools
export PATH=$PATH:/Users/<YourUsername>/Library/Android/sdk/platform-tools保存并运行:
1
source ~/.bashrc # 或 source ~/.zshrc
4. 使用命令行启动 AVD
如果没有 Android Studio 的图形界面,可以使用命令行启动 AVD:
打开命令行或终端。
使用以下命令启动模拟器:
1
emulator -avd <avd_name>
其中,
<avd_name>
是创建的虚拟设备名称。如果没有创建 AVD,可以通过以下命令创建一个新的虚拟设备:
1
avdmanager create avd -n <avd_name> -k "system-images;android-30;google_apis;x86_64"
5. 检查 AVD 是否可用
可以列出可用的 AVD:
1 | avdmanager list avd |
如果仍然无法找到 AVD Manager
,可能是 SDK 安装有问题,尝试重新安装 SDK 或 Android Studio。
总结:
- 确保 SDK 工具和模拟器已经正确安装。
- 配置
PATH
环境变量,确保命令行工具可用。 - 使用
avdmanager
命令手动创建 AVD(如果需要)。 - 通过命令行启动模拟器,或者通过 Android Studio 使用 AVD Manager。
6.VS Code 中成功启用 GitHub Copilot,需要完成以下 5 个关键步骤。
✅ 1. 安装 GitHub Copilot 插件
打开 VS Code
按
Ctrl + Shift + X
打开扩展(Extensions)搜索并安装插件:
1
GitHub Copilot
✅ 选择 GitHub 官方发布的那个(发布者是
GitHub
)
✅ 2. 登录的 GitHub 账户
安装后,VS Code 会提示:
“GitHub Copilot requires authentication”
点击“Sign in”
浏览器会打开 GitHub 授权页面
确认授权并登录的 GitHub 账号
⚠️ 必须是:
- 拥有 Copilot 订阅(付费或试用中)
- 或属于 GitHub Copilot 企业授权的用户
✅ 3. 验证登录成功
登录成功后,可以:
在 VS Code 命令面板中(
Ctrl + Shift + P
)输入:1
Copilot: Status
✅ 若看到 “Logged in as your_github_name” 即为成功。
✅ 4. 启用自动补全
打开的代码文件(.dart
, .js
, .py
, .cpp
等都支持),开始写函数名,Copilot 会自动在灰色字体中提示补全建议。
可以按:
Tab
→ 接受补全建议Esc
→ 忽略建议
✅ 5. 可选:安装 Copilot Chat(对话增强版)
如果希望像 ChatGPT 那样和 Copilot 聊天,获取更复杂建议,还可以安装:
1 | GitHub Copilot Chat |
这个插件支持自然语言提问,例如:
“帮我写一个 Flutter 登录界面”
“优化这个函数的性能”
🛠️ 常见失败原因排查
问题 | 解决方法 |
---|---|
登录失败 / 没有跳转到浏览器 | 手动执行 GitHub: Sign in 命令 |
提示 “Copilot setup failed” | 使用 VPN,或设置代理 + 重新登录 |
看不到建议补全 | 关闭中文输入法、确认当前语言支持(如 Dart) |
提示需订阅 | 登录 GitHub → https://github.com/settings/copilot 确认是否开通 |
6.✅ 附加建议:测试是否工作正常
可以在新文件中输入以下代码片段测试:
1 | void main() { |
看是否自动灰色提示 print("Hello World");
或其它逻辑。
如操作中遇到某个具体步骤失败,欢迎贴出提示信息,我可以帮一步步修复。是否需要我检查现在的系统环境变量、代理配置或 Dart/Flutter 插件兼容性?
9. 在 Android Studio 或 VS Code 中配置 Virtual Device(模拟器) 时,选择合适的设备型号和系统镜像(API Level)非常关键。
✅ 推荐虚拟设备配置(2025 年通用建议)
类型 | 推荐选项 | 说明 |
---|---|---|
设备型号 | ✅ Pixel 4 / Pixel 5 | 主流分辨率、性能适中,适配广泛 |
✅ Pixel 6 / Pixel 7 (高性能) | 测试新特性(如Material You),但更吃资源 | |
✅ Nexus 5X (轻量) | 对低配电脑更友好 | |
系统版本 | ✅ Android 13 (API 33) | 现主流设备系统,Flutter 支持稳定 |
✅ Android 12 (API 31) | 稳定、兼容性强 | |
✅ Android 11 (API 30)(轻量备选) | 更轻,占用内存小,可用于低端设备模拟 | |
镜像类型 | ✅ x86_64 或 ARM64 系统镜像 | 推荐选 x86_64(支持更快的 emulator 加速) |
✅ Google APIs(非 Google Play) | 大多数 Flutter 应用足够使用,不必安装 Play 支持版本 | |
⚠️ Google Play 版本 | 体积大、启动慢,一般只在测试 Play 依赖时使用 |
🛠️ 示例推荐配置(开发+测试兼顾)
1 | Device: Pixel 5 |
❗ 不建议选择:
不推荐配置 | 原因 |
---|---|
Android 10 以下 | 支持减弱,Flutter 新特性可能不兼容 |
Google Play 系统镜像 | 体积大、启动慢、更新频繁 |
ARM 映像(除非 M1/M2 Mac) | 模拟速度慢,不支持加速 |
💡 Flutter 快速测试建议
可以选配两个虚拟设备:
目的 | 推荐设备 | API 版本 |
---|---|---|
日常开发调试 | Pixel 5 | Android 13 |
向下兼容测试 | Nexus 5X | Android 11 |
高端设备体验测试 | Pixel 7 | Android 14(如可用) |
📌 重要提示:性能建议
- 启用 Hardware Acceleration(加速),否则模拟器会非常卡
- 如果是 AMD CPU,确保已启用 Windows Hypervisor Platform
- 推荐使用 x86_64 镜像 + Cold boot only once 提高启动速度
10.当前的 Java 环境是:
1 | openjdk 18 2022-03-22 |
✅ 这表明已经安装了 OpenJDK 18,完全符合 Android 开发(尤其是 Android 14 / API 34)对 Java 版本的要求(Java 17 或更高)。
✅ 那么为什么仍然提示 “Java version 17 or higher is required”?
这种情况通常有两个可能原因:
🔍 原因 1:Android Studio / Gradle 没有使用当前的 JDK 18
即使安装了 JDK 18,如果的 JAVA_HOME
没有正确配置,Android Studio 或 flutter build
命令仍然可能默认使用旧版本 JDK(比如 JDK 8 或 JDK 11)。
✔️ 解决方法:
✅ 设置 JAVA_HOME 环境变量
Windows:
打开“环境变量设置”。
添加 / 修改系统变量:
变量名:
JAVA_HOME
变量值: JDK 18 的安装路径,比如:
1
C:\Program Files\Java\jdk-18
在系统变量
Path
中添加:1
%JAVA_HOME%\bin
打开新终端,运行:
1
2java -version
echo %JAVA_HOME%
macOS/Linux(bash/zsh):
编辑 ~/.bashrc
或 ~/.zshrc
文件,添加:
1 | export JAVA_HOME=/path/to/your/jdk-18 |
然后运行:
1 | source ~/.bashrc # 或 ~/.zshrc |
🔍 原因 2:Android Studio 项目仍指向旧 JDK 路径
即使系统环境正确,Android Studio 本身可能还指向旧 JDK 路径。
✔️ 在 Android Studio 中设置正确的 JDK 版本
打开 Android Studio。
进入菜单:File > Project Structure > SDK Location。
找到 JDK Location 字段,点击右侧文件夹图标。
指向 JDK 18 的路径,如:
1
C:\Program Files\Java\jdk-18
点击 OK 保存设置,重启 Android Studio。
🔁 最后验证
确保以下命令都输出了 JDK 18 相关信息:
1 | java -version |
如果是在使用 flutter
构建 Android 应用,也可以运行:
1 | flutter doctor -v |
确认输出中使用的是正确的 Java 路径和版本。
✅ 总结
项目 | 当前状态 |
---|---|
已安装 OpenJDK 18 | ✅ 没问题 |
是否满足 Android 14 要求 | ✅ 满足(17+) |
仍提示版本问题原因 | 多半是 JAVA_HOME 未正确设置或未被 Android Studio/Gradle 识别 |
若你觉得我的文章对你有帮助,欢迎点击上方按钮对我打赏